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ABSTRACT 


A cross  assembler  and  simulator  for  the  EMMY  micro- 
programmable  processor  has  now  been  developed  and 
will  shortly  be  generally  available  for  EMMY  Lab 
users.  The  program  is  written  in  ALGOL  W and  presently 
exists  on  the  Campus  360/67,  however,  in  the  future  it 
should  also  be  available  at  SLAC  or  the  SCIP  168. 


The  work  herein  was  supported  in  part  by  the  Army  Research  Office-Durham  under 
contract  DAHC  04-76-G-0001. 
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THE  CROSS  ASSEMBLER  LANGUAGE 


At  CHARACTER  SET:  The  cross  assembler  accepts  EBCDIC  characters, 
including  ASCII:  't 

Bt  IDENTIFIERS:  Identifiers  may  be  from  one  to  eight  (8) 
characters*  Characters  beyond  the  eighth  will  be  ignored  by  the 
assembler*  Identifiers  conform  to  the  following: 

1*  First  character  must  be  ALPHA(BETIC ) . upper  or  lower 
case;  or  the  dollar  sign  '$'* 

2*  The  second  and  following  characters,  if  any.  may  be 
ALPHA.  NUMERIC  the  dollar  sign.  or  the  underscore 


C*  RESERVED  IDENTIFIERS:  Certain  identifiers  are  reserved  for 
special  use  of  the  assembler  and  are  not  available  to  the 
programmer  as  ordinary  identifiers*  The  reserved  identifiers  are 
all  upper  case  alphabetic  characters* 


D*  COMMENTS:  Comments  may  be  included  on  any  assembler  statement 
by  prefacing  the  comment  with  a period  ('*')  or  vertical  bar 
('!')*  A comment  may  be  the  only  item  on  a line,  and  totally 
blank  lines  may  be  included  in  the  input* 


E*  STATEMENT  FORMAT:  Statements  are  coded  entirely  within  card 
columns  1-72  and  no  continuation  is  allowed*  The  contents  of 
columns  73-80  is  printed  on  the  listing  but  otherwise  ignored* 

[<LABEL  ID>:]  [ <T-STATEMENT> ] [ ; <A-STATEMENT> [ ; <UPDATE  PTR>]] 

Machine  code  statements  follow  the  basic  form  given  above, 
with  numerous  minor  variations.  of  course*  Blanks.  beyond  a 
single  one  used  to  delimit  other  quantities.  are  ignored  and 
coding  is  free  form  v/ithin  a statement* 

If  no  a-statement  is  coded  then  it  and  the  semicolon 
preceding  are  omitted,  and  this  also  precludes  coding  any  <UPDATE 
PTR>*  Likewise  if  the  t-statement  is  not  coded.  then  it  is 
omitted  with  the  a-  statement  beginning  as  shown  with  a semicolon* 

One  or  more  label  identifiers  may  be  attached  to  a statement 
by  coding  each  before  other  items  on  a given  line,  and  following 
each  LABEL  I*D*  with  a colon  (':')*  If  a LABEL(s)  is  left 
'hanging',  (i*e*  coded  on  a line  containing  no  machine  statement) 


1-  1 


then  the  label  is  assigned  the  current  value  of  the  location 
counterT 


F»  IDENTIFIER  TYPES:  The  assembler  defines  different  types  of 
identifiers  as  follows: 


TYPE 

DESCRIPTION 

RANGE  OF 

VALUES 

ABS 

ABSOLUTE  NUMERIC 

3>  31 

-2  < n < 2 

-1 

SYMB 

SYMBOLIC  LABEL 

0 < n < 2*^ 

-1 

REG 

HARDWARE  REGISTER 

R0.R1.R2.R3. 

R'I.R5.R6.R7 

MASK 

CONDITICNAL  MASK 

ALL  2"  of  2 

> ,Ov  ,0 

’ ( / ) • ( j ) • 

G»  LITERALS:  The  assembler  accepts  literal  constants  coded  in 
any  of  the  forms  belov/»  All  literal  constants  are  like  an 
identifier  type  ABS.  except  * which  is  SYMB* 

>DECIMAL  nnnnnn  (<  2^'  -1) 


>HEX  X'nnnnnnnn'  (<  8 HEX  DIGITS) 

>OCTAL  O'nnn-n'  (<  2^'  -1) 

>BIMARY  B'(t)(®)---*(?)  ' (S  32  BINARY  DIGITS) 

>CHARACTER  C'cccc'  (<  4 CHARACTERS) 

(NOTE:  Character  constants  are  converted  to  ASCII  and  packed 

right  justified  in  8 bit  fieldsT  No  parity  bit  is  given  so 
the  high  bit  of  all  bytes  is  zero») 

>LOCATION  COUNTER  » [TYPE  IS  SYMB] 

(NOTE:  The  * gives  the  location  counter  value  or  the  address 
of  the  current  instruction  being  processed^) 


1 
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H»  EXPRESSIONS:  Literals  and  identifiers  of  types  AB3  and  SYMB 
nay  appear  in  expressions  as  follov/s  (and  only  as  below): 


UNARY  -: 

--ABS 

NEGATE 

UNARY  +: 

++ABS 

NULL  (NO  ACTION) 

BINARY  -: 

ABS,  -- 
SYMB, -- 

ABSt 

SYMB;, 

YIELDS 

YIELDS 

ABS 

ABS 

RESULT 

RESULT 

BINARY  +: 

ABS,  + + 
ABS  + + 
SYMB,  + + 

ABSu 

SYMB 

SYMBjj^ 

YIELDS 

YIELDS 

ERROR 

ABS 

SYMB 

RESULT 

RESULT 

Multiple  operators  are  evaluated  from  left  to  right.  No 
parentheses  may  be  used. 


I.  >SEUDO-OPS: 


1.  DC  - DEFINE  CONSTANT 

DC  <EXPRESSION> 

This  statement  reserves  one  word  of  storage.  The  statement 
may  have  a label,  whose  value  would  be  the  address  of  the 
constant.  The  <EXPRESSION>  may  be  ABS  or  SYMB. 


2.  BLK  - BLOCK 

BLK  <ABS-EXPR> 


Reserve  <ABS-EXPR>  words  of  storage.  The  label.  if 
coded,  is  the  address  of  the  first  word.  The  expression  must 
be  ABS. 


3.  ORG  - ORIGIN  LOCATION  COUNTER 
ORG  <EXPRESSION> 

Begin  assembling  code  (starting  with  next  statement)  at 
location  <EXPRESSION> . vrhich  may  be  ABS  or  SYMB.  It  is  poor 
form  to  label  an  ORG  statement  although  the  assembler 
probably  would  allow  it. 
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4,  EQU  EQUATE  SYMBOL 

■<REG> 

<IDEMTIFIER>  EQU  )<EXPRESSION> 

<MASK> 

.<TDENTIFIER> 

NOTE:  MASKS  are  defined  usinf;  'MASK'  function  as 

f ollov/s : 

MASK  ( <EIGIITBITS>  . <NOT>  . <ZERO>  . <CODES>  ) 

The  four  fields  are  all  ABS  and  <EIGHTBITS> 
is  0<  <255  while  the  other  fields  are  0 or  1 
only, 

<EIGHTBITS>  IS  THE  TEST  MASK 
<NOT>  = 1 . INVERTED  SENSE 
<ZER0>=1  . TEST  INVERTED  (FOR  ZERO) 

<C0DES>i1.  TEST  INDICATOR  CODES 

(INSTEAD  OF  CONDITION  CODES) 

The  EQU  <IDENTIFIER>  must  not  have  been  used  as  a label 
identifier  nor  may  it  appear  at  the  left  in  another  EQU, 
The  <IDENTIFIER>  is  given  the  type  and  value  of  the  quantity 
on  the  right  of  the  EQU,  A register.  mask  define, 
expression,  or  identifier  may  appear  on  the  right  in  the  EQU, 
A restriction  exists  that  any  identifier  appearing  at  the 
right,  either  alone  or  in  an  expression,  must  have  been  given 
its  value  earlier  in  the  program. 


5,  END 

END  [<LABEL>] 

The  EN'D  PSUEDO-OP  marks  the  last  physical  statement  of 
the  program.  The  optional  <LABEL>  specifies  a point  to 
transfer  control  to  begin  execution. 


T - STATEMENT 


It  arithmetic 


To  store  result  A set  codes; 


Raf  :=  Raf 


(+0+1  Rbf 

1 - 

I -b-J  (litef 


To  only  set  code; 


Raf  1 +C+ I iRbf 


2t  logical 


Raf  ; = 


NOTE: 


-b-  I LITERAL 


0 or  - 1 

LITERAL  or  LABEL 
MOT  <0P2> 

Raf  <LOG>  <0P2> 
Rbf 


MAY  BE  USED  FOR  'NOT' 

<0P2>:  Rbf  or  LITERAL  *2* 

<LOG>:  AND  or  OR  or  NAND  or 

NOR  or  XOR  or  XNOR 

Raf  :=  Rbf  DOES  A 'LTR'.  THAT  IS 

LOADS  AND  SET  CONDITION  CODES 


*1*  LITERAL  is  assembled  short  if  0 < LIT  < 7 and  an 
A-STATEMENT  is  coded,  otherwise  it  is  long» 

*2*  LITERAL  or  LABEL  with  value  0 or  -1  are  assembled 
short,  other  values  generate  a long  literal  form» 


W 


3»  SHIFT. ROTATE 


SINGLE: 

Raf  <S-OP>  |Rbf  I 

(LITERAL)  *1* 

DOUBLE: 

Raf  Raf©1  <S-OP>  jRbf  ] 

(literal)  *1* 

<S-OP>:  <<  LEFT  LOGICAL 

<Q  LEFT  ROTATE 
<<  RIGHT  LOGICAL 
§<  RIGHT  ARITHMETIC 

4.  EXTENDED 
TRANSFER 

Raf  = Rbf  [NOTE:  CONDITION  CODES  NOT  SET] 
DIVIDE  STEP 


DIV  (Raf, Rbf) 


MULTIPLY  STEP 


MUS  (Raf^jRbf) 


EXCESS  SIX 


XS6  (Raf, Rbf) 


*1*  LITERAL  is  assembled  short  if  0<  LIT  <7  and  an 
A-STATEMENT  is  coded,  otherwise  it  is  long. 
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5.  EXTRACT/IMSERT 


Raf  (<LIST>) 


Rbf  (<n,  >:<n^>) 


[I 


CLEAR  M 
INSERT)] 


<LTST>  is  one  or  more  of  the  following;  separated 
by  commas 

a»  <i|>  : <io>  position  through  i,  *1* 

b,  position  ij 


Rbf  is  rotated  assuming  the  <no>  of  Rbf  will  be  matching 
the  last  i argument  (furtherest  to  "■ight)  of  <LIST>  for 
Raf, 

If  'clear'  is  coded  an  EXTRACT  is  done  otherwise  an 
INSERT,  The  ACTION  is  to  assign  the  bit  field  given  by 
<n,>  : <n^>  in  Rbf  to  Raf  into  those  bits  given  by  <LIST> 
and  leave  the  the  others  the  same  (or  clear  them  if 
'CLEAR' ), 


\ 

i 

i 

! 


{ 

i 


t! 

I 

f 


6,  CONDITIONAL 

([NOT]  <MASK>  =>  [; ] <A-STATEMENT> ) 


The  entire  statement  is  surrounded  by  a set  of 
parentheses,  including  the  <A-STATEMENT>,  The  <MASK> 
must  be  either  the  'MASK(i  i .i  ^i  )'  or  an  IDENTIFIER 
with  TYPE  MASK,  The  test  may  be  inverted  by  specifying 
'not',  NORMAL  if  the  test  is  satisfied  the  <A-STATEMENT> 
is  EXECUTED,  otherwise  it  is  skipped. 


*1*  If  i*>  i,  then  positions  31  to  i and  i to  0 are  selected 
(it  wraps  around).  Remember  not  all  possible  masks  can 

; be  represented  in  the  18  bit  literal  field, 

t 

I 

I 

I- 

I 

1 

I 

i 
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Kt  A-STATr';MENT 

1.  STORE  REGISTER 
M(<EXPRE5SI0:'1>  ) = Ref 

2,  LOAD  ..EQ-^STER 

Ref  = M( <EX PR ESSION>  ) 

3.  LOAD  IMMEDIATE 
Ref  = <EXPRESSIOM> 

[ this  ineludes  <LABEL> 's  and  type  SYMB] 

4,  INDIRECT  ACCESS 

M(Ref)  = X(Rdf) 

Ref  = X(Rdf) 

X(Ref)  = Rdf 
X(Ref)  = M(Rdf) 

Ref  = M(Rdf) 

M(Ref)  = Rdf 
Ref  = Rdf 

NOTE:  To  do  POINTER  UPDATE  inelude 

Either 

; Ref  = Ref  {i}  LIT  or 
; Rdf  = Rdf  {t } LIT  or 

; Ref  = Ref  {t}  LIT  ; Rdf  = Rdf  {1}  LIT 


5t  POINTER-MOD  AND  LOOP 

INC  Ref 
DEC  Rex' 

Ref  = Ref{  }Rdf 


( 


If  <LABEL>  is  used  must  be  equivalent  to  RO  ^ 
where-8<LIT<7 


)TE:  To  do  CONDITIONAL  LOOP  inelude 


[NOT] 


M 0 [=>]  )) 

=3  (<LABEL>  3 


APPENDIX 


A.  PREDEFINED  MASKS 


ZERO 

NEGATIVE 

POSITIVE 

OVERFLOW 

CARRY 

HIGH 

LOW 

SAME 

ODD 

BUSY 


1 

CARRY  BIT  = 1 j 

HIGH  BIT  = 1 I 

LOW  BIT  = I I 

ALL  BITS  0 or  1 ; 

PARITY  IS  ODD 
CPU  BUS  ACCESS  IS  BUSY 


B,  RESERVED  WORDS 


RO 

INSERT 

R1 

CLEAR 

R2 

R3 

MUS 

R4 

DIV 

R5 

XS6 

R6 

R7 

DEC 

INC 

AMD 

OR 

ZERO 

HAND 

POSITIVE 

NOR 

NEGATIVE 

XOR 

OVERFLOW 

XNOR 

CARRY 

:jot 

FilGH 

LOW 

MASK 

SAMS 

EQU 

ODD 

3LK 

BUSY 

END 

DC 

ORG 

X + 

M+ 

+ only  when  directly  follov/ed  by 


1. 


c. 


\ 


> 


\ 


